home *** CD-ROM | disk | FTP | other *** search
Text File | 1994-11-04 | 39.0 KB | 1,153 lines |
-
-
- █▀▀▀▀▀▀▀ █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
- █ ▀█▀▀▀█ █ ▀█▀▄▀█ █▀█ █▀ █▀
- █▀ █ █ █ █▀ █ █ █ █ █ █
- █ █ █▄█ █ █ █ █ █ █▀ █▀
- █ █ █ █ █ █ █ █ █ █
- █ █ █ █▄ █ █ █▄█ █▄ █▄
-
- DOCUMENTATION
-
- Anonymous FTP Emcee
- Version 1.0
- Vault Information Services
-
- Written by JJ Heim
- jj.heim@boardwatch.com
- November 1994
-
- Copyright (c)1994
- All Rights Reserved
-
-
- 1 INTRODUCTION
-
- 1.1 Features
-
- 1.2 Internet Access
-
- 1.3 Requirements
-
- 1.4 Unlocking Emcee: REGISTRATION°
-
-
- 2 SETUP
-
-
- 3 NORMAL FTP ACTIVITIES: Getting Emcee Online
-
- 3.1 Connecting to an Anonymous FTP Site
-
- 3.2 Listing Directories
-
- 3.3 Viewing Files
-
- 3.3.1 Viewing HTML Files
-
- 3.4 Logging Off
-
- 3.5 Direct Communication Link
-
-
- 4 FILE TRANSFERS
-
- 4.1 Retrieving Documents
-
- 4.1.1 Viewing the Last Document
-
- 4.2 Downloading
-
- 4.3 Uploading
-
- 4.4 Transfer Log
-
- 4.4.1 Resetting the Transfer Log
-
-
- 5 ARCHIE AND WHATIS SEARCHES°
-
- 5.1 Viewing the Last Archie Search
-
- 5.2 Viewing the Last WhatIs Search
-
- 5.3 Specifying Archie Servers
-
-
- 6 PERSONAL FTP DIRECTORY
-
- 6.1 Adding New Sites
-
-
- 7 INSIDE EMCEE
-
- 7.1. CHaiN: Cursor-Happy Navigation
-
- 7.2. Specifying a Home Page
-
- 7.3. Searching the Window
-
- 7.4. Saving the Window to Disk
-
- 7.5. Printing the Window
-
-
- 8 TECHNICAL SUPPORT
-
- 8.1 Further Information
-
-
-
-
-
-
-
-
- 1. INTRODUCTION
- ______________________________________
-
- Anonymous FTP (File Transfer Protocol) is one of the
- numerous methods of retrieving information the Internet has to
- offer. This protocol is a direct link to several thousand
- servers offering free anonymous access to a medley of files.
- More than technical information, and much more that just
- executable programs, the content of an FTP site varies heavily,
- each offering a share to the world's biggest hard drive.
-
- Navigating through anonymous sites, browsing among the
- directories or just downloading files from the flat Unix command
- line can be burdensome. Emcee is a shell to interact with the
- FTP command line and make your visit easier to use and faster to
- move through.
-
- Emcee also allows integrated access to Archie and Whatis
- databases, to aid in locating and describing files of interest.
- All aspects of finding, viewing and getting files from FTP are
- featured, from one very "surfable" interface.
-
- Please note: Some anonymous FTP sites request that you
- utilize them during off-peak hours (6am-6pm), while others are
- available 24 hours. Please respect their wishes as to how you
- use their system, for they're providing a considerable amount of
- virtual happiness to millions.
-
-
-
-
- 1.1 Features
- ______________________________________
-
- FTP by itself allows you to browse directories, download,
- upload and view files on FTP sites. The Archie resource searches
- several thousand anonymous FTP sites for files. WhatIs searches
- file descriptions. Both Archie and WhatIs require Telnet access
- and a registered version of Emcee.
-
- Every aspect of interactive Anonymous FTP is integrated into
- Emcee, providing you the most convenient way to fully utilize
- information that's so readily available.
-
- * CHaiN
- Emcee automates the FTP experience through CHaiN, "Cursor-Happy
- Navigation." By moving the cursor to the desired filename, you
- can execute a variety of commands just by pressing (enter).
-
- * Personal Directory
- A Personal Directory also lets you reference favorite sites,
- files and directories for immediate non-stop access to desired
- information.
-
- * Archie/Whatis Searches
- Locate files and file descriptions available from Anonymous FTP
- sites everywhere. The outcome of ARCHIE/WhatIs searches bring
- back a formatted listing, fully CHaiNable and ready to escort
- you to interesting resources.
-
- * HTML Support
- Files formatted under the Hypertext Markup Language are
- automatically translated to their intended nature,
- highlighting FTP site and file references.
-
- * Fully Automated FTP Sessions
- Emcee automatically logs in anonymously, using your email
- address as the password.
-
- * NSCT Technology (Windows(tm) Spoof)
- "Never the Same Command Twice" All directories are remembered
- from login to logout of each site. Allows for quick back-
- stepping.
-
- * On-the-Fly Performance
- Shift through directories/files in memory while receiving
- more.
-
- * Direct-Link "Raw" Communication Mode
- For troubleshooting or timeout problems: freedom to manually
- control the connection from the original command line.
-
-
-
-
- 1.2 Internet Access
- ______________________________________
-
- Emcee requires that you access the Internet through a
- terminal connection provided by a BBS, online service or dial-up
- server. Emcee is not a TCP/IP stack of any sort, but rather a
- smart interface used directly over a Unix, Linux or similar dial-
- up "shell account."
-
- The TYPE of terminal interface you use is important. A good
- dial-up Internet provider should offer one prompt where ALL
- available internet protocols (such as telnet, FTP, finger,
- etc...) can be performed (hereon considered the Host Prompt).
- This prompt is essential for Emcee to function properly, as it
- offers the preferred "raw" shell.
-
- Equally important is whether your provider uses an FTP
- client that produces VT100 codes (or colors) anywhere WITHIN an
- FTP session (besides the Host Prompt). These codes generally
- make it easier for the user to navigate, but causes problems due
- to unforseen prompts in the Emcee environment. Therefore, the
- best solution is a "dumb" terminal connection. Ask your provider
- just how unfriendly their terminal access can be.
-
-
-
-
- 1.3 Requirements
- ______________________________________
-
- * FTP/Telnet access through a terminal-based, or "shell account"
- Internet connection (see above). Telnet access optional.
-
- * MS-DOS v3.0+
-
- * Hard drive and a couple free Megs
-
- * 300K available RAM
-
- * VGA/compatible monitor
-
-
-
-
- 1.4 REGISTRATION: More Features
- ______________________________________
-
- Emcee is a fully user-supported application. If you use
- Emcee for private or commercial purposes, you're asked to pay for
- it. While not completely enforceable, registering is highly
- respectable and appreciated.
-
- $12 will get you a registered version of Emcee, which
- includes the FULL Archie/Whatis option. As mentioned above,
- Archie and Whatis searches allow extensive listings of available
- files from hundreds of sites, completely incorporated into an
- Emcee format. (ARCHIE is based on an interactive Telnet
- connection.)
-
- You can choose to register Emcee by credit card or
- check/money order. Upon receiving payment, we'll immediately
- email back a Registration Patch and instructions to turn Emcee
- into the official registered version.
-
-
- TO REGISTER BY VISA/MASTERCARD (Zero Paperwork)
-
- The fastest way to register is by sending a scrambled
- version of your credit card number to us through Internet e-mail.
- E-mail provides an efficient, but not necessarily reliable means
- of communication. We will not be held responsible for misplaced
- or unsuccessful delivery of e-mail messages, but don't hesitate
- to try.
-
- 1) Use the REGISTER utility (distributed with Emcee) to
- scramble your credit card number and expiration date.
- This will return a 22-digit scrambled version of your
- credit card.
-
- 2) Send e-mail to: vis@vaultbbs.com
-
- Include the following:
-
- 1) SUBJECT should be "EMCEE"
- 2) The scrambled version of your credit card
- 3) The cardholder's name
- 4) The e-mail address you use in Emcee
- (IMPORTANT: make sure it's the same one!)
-
-
- TO REGISTER BY CHECK/MONEY ORDER
-
- Follow the instructions from the Registration command from
- the menubar's first box. This involves printing a registration
- form and sending it with payment via USPS (snail) mail.
-
-
-
-
-
-
-
-
- 2. SETUP
- ______________________________________
-
- Before Emcee can run, the SETUP program needs to configure
- Emcee's basic operating defaults. The modem port, your e-mail
- address and Host Prompt are mandatory options. Details of each
- option follows.
-
-
- MODEM PORT
- The port number where the modem is connected. Valid: ports 1-4.
- Com1 & Com3 use IRQ4, Com2 & Com4 use IRQ3 (standard). If there
- is a need for other IRQs or ports, let me know.
-
-
- PRINTER PORT
- The port number of your printer. Valid: ports 1-3.
-
-
- E-MAIL ADDRESS
- Your Internet e-mail address. If you enter a non-standard
- address, some FTP sites will decline access.
-
-
- FILE LOCATION
- Where Emcee's data files are kept. However, it's good practice
- to keep all of Emcee's files under the same directory as the
- Emcee program.
-
-
- HOST PROMPT
- The prompt your providing system offers that allows you to
- perform both FTP and Telnet commands from. Access to at least
- FTP from this prompt is necessary for Emcee to function properly.
- Some examples: TBBS systems normally use "Cmd>" and Linux systems
- use "~:".
-
-
- FTP COMMAND
- The command you normally issue at the Host Prompt to connect with
- an FTP site. (Usually, almost always 'ftp').
-
-
- TELNET COMMAND
- Optional. Like the FTP Command, the command that will connect
- instead with a Telnet site. (Most likely 'telnet') Only needed
- for archie/whatis functions.
-
-
- DIRECTORY COMMAND
- The command that performs a directory listing during a session.
- (Usually 'dir') Try typing "help" at an ftp> prompt to see what
- commands you have available.
-
-
- VIEW COMMAND
- The command that shows the content of a file. If you're using a
- unix-based provider such as Linux, leave this option blank and
- Emcee will simulate a viewing by downloading the file and viewing
- it from your local host. TBBS's command is "read".
-
-
- MAXIMUM ARCHIE FINDS
- The maximum number of "hits" to bring back during an Archie
- search. Max: 999.
-
-
- ARCHIE SEARCH TYPE
- This defines the type of Archie searches you wish to perform.
- Options are:
-
- sub Substring (case insensitive). A simple, everyday
- substring search. A match occurs if the file (or
- directory) name in the database contains the user-given
- substring.
-
- Example: "is" will match "islington" and "this" and
- "poison"
-
- subcase
-
- Substring (case sensitive). As above but the case of the
- strings involved becomes significant.
-
- Example: "TeX" will match "LaTeX" but not "Latex" or
- "TExTroff".
-
- exact
-
- Exact match. The fastest search method of all. The
- restriction is that the user string has to _exactly_
- match (including case) the string in the database. This
- is provided for those of you who know just what you are
- looking for.
-
- For example, if you wanted to know where all the
- "xlock.tar.Z" files were, this is the kind of search to
- use.
-
- regex
-
- This is the DEFAULT search method. Searches the database
- with the user (search) string which is given in the form
- of an ed(1) regular expression.
-
- NOTE: Unless specifically anchored to the beginning (with
- ^) or end (with $) of a line, ed(1) regular expressions
- have ".*" prepended and appended to them. For example, it
- is NOT NECESSARY to say
-
- prog .*xnlock.*
-
- since
- prog xnlock
-
- will suffice. Thus the regex match becomes a simple
- substring match.
-
- There are also compound searches made up of combinations
- of the above search methods in sequence:
-
- exact_sub
-
- Try "exact". If no matches found use "sub".
-
- exact_subcase
-
- Try "exact". If no matches found use "subcase"
-
- exact_regex
-
- Try "exact". If no matches found use regex.
-
-
-
- LOGIN DELAY
- The amount of time to wait for your provider to successfully
- connect with an FTP Site.
-
-
- PROMPT WAITING DELAY
- The amount of time to wait for the "ftp>" prompt after issuing
- the anonymous FTP logon sequence.
-
-
- TIMEOUT DELAY
- The amount of *idle* time during a directory listing or file
- viewing session before Emcee declares a timeout and ponders for
- attention.
-
-
- MODIFYING COLORS
- You have the option to customize the colors Emcee displays. Use
- the Up/Down arrow keys to choose what to change and Right/Left
- keys to change colors.
-
-
- SAVE/EXIT
- Saves changes and exits SETUP.
-
-
- EXIT/ABORT
- Doesn't save any changes and exits SETUP.
-
-
-
-
-
-
-
-
- 3. NORMAL FTP ACTIVITIES
- ______________________________________
-
- Emcee is full functioning only after you have connected with
- your provider and positioned their system at the HOST PROMPT
- through a terminal connection. Shell or exit to DOS from your
- terminal program without dropping the connection, go to Emcee's
- directory and type "emcee".
-
- If Emcee cannot find the HOST PROMPT, you'll be asked to
- manually control the connection and steer the provider's system
- back to the HOST PROMPT. If you start Emcee without a connection
- at all, you can still play around, but all FTP options are of
- course, disabled.
-
- If all works well, your Personal Directory pops up and
- you're ready to go.
-
-
-
-
- 3.1. Dialing an Anonymous FTP Site
- ______________________________________
-
- An FTP site name looks like this: oak.oakland.edu
-
- * Use the "Connect/Relieve" command from the Personal Directory
- <F1> to connect with the highlighted entry, or
-
- * If you notice a site name ANYWHERE in the window, move the
- cursor to it and press (Enter). Use the "Connect" command to
- visit the site.
-
- NOTE: It's unnecessary to logoff before connecting to another
- site.
-
- If you press (Esc) while waiting to connect, you'll be given the
- option to RETRY, ABORT or perform a DIRECT COMMUNICATION LINK.
-
-
-
-
- 3.2. Listing Directories
- ______________________________________
-
- Upon connecting with an FTP site, Emcee will automatically
- retrieve the first directory. The listing may look somewhat
- complex, but somewhere in the listing, there will be directory
- names and files. You might see something like:
-
- Size Filename/Directory
- -------- ----------
- -rw-r--r-- 1 pvo staff 6130 Aug 3 10:24 README
- -rw-r--r-- 1 pvo staff 512 Jan 6 1993 Adlib-Gold
- -rw-r--r-- 1 pvo staff 512 Apr 16 1992 Alesis-D4
- -rw-r--r-- 1 pvo staff 512 Dec 11 1992 Analog_FAQ
- -rw-r--r-- 1 pvo staff 90926 May 18 1993 CD-ROM.txt
- -rw-r--r-- 1 pvo staff 512 Apr 19 13:36 CDI-FAQ
- -rw-r--r-- 1 pvo staff 512 Mar 4 1992 Casio-VZ
- -rw-r--r-- 1 pvo staff 512 Apr 15 1992 Chroma
-
- The names and directories appear on the far right-hand of the
- screen.
-
- Directories are distinguished by having a SIZE of 512 or
- multiple.
-
- (1) Position the cursor so it's touching the name of the
- directory, and press (Enter).
-
- (2) Make sure the directory you wish to move to is listed in the
- box and press (Enter) again.
-
- (3) Use the "Directory" command to list it.
-
-
-
-
- 3.3. Viewing Files
- ______________________________________
-
- (1) Move the cursor to the file you wish to view and hit (enter).
-
- (2) Confirm the name and press (Enter) again.
-
- (3) Use the "View" command to view it.
-
-
-
-
- 3.3.1. Viewing HTML Files
- ______________________________________
-
- Same as above, but when the file is received, it'll be structured
- automatically to a readable format, highlighting all FTP sites
- and file references.
-
-
-
-
- 3.4. Logging Off
- ______________________________________
-
- Press <F8> to immediately log off the FTP site you're connected
- to. If you perform this while receiving a file, there may be an
- unexpected delay, in which case Emcee will react with an urge to
- perform a Direct Communication Link.
-
-
-
-
- 3.5. Direct Communication Link
- ______________________________________
-
- Press <F9> to get to a command prompt. This will place you in
- direct contact with your provider's system, where you can
- manually issue commands.
-
- Press <Esc> when you finish. It's a good idea to return to the
- Host Prompt before going back into Emcee. If you're in an FTP
- session, Emcee will take you out of the Link and start over.
-
-
-
-
-
-
-
-
- 4. FILE TRANSFERS
- ______________________________________
-
- The most important aspect of FTP is, well, it's files. Downloads
- are sent from the remote FTP site to your provider's system where
- you must manually download them again to YOUR system, later.
-
-
-
-
- 4.1. Retrieving Documents
- ______________________________________
-
- Retrieving a document places a remote file's content in the
- window and makes it the "Last Document". During an FTP session,
- use the "view" command to get the same results without disturbing
- the actual Last Document.
-
- You'll need the site+filename to successfully retrieve.
-
- (1) Press (Enter) anywhere on the screen.
-
- (2) Erase whatever CHaiN captured and input the site, followed by
- "/" and then the directory and filename (no spaces). Press
- (Enter).
-
- (3) Choose "Connect".
-
- (4) Choose "Document (Screen)".
-
- Emcee will call the site, and retrieve the file to your screen,
- then logoff. This file will remain the Last Document until you
- perform this again.
-
-
-
-
- 4.1.1. Viewing the Last Document
- ______________________________________
-
- Pressing <Alt-D> will display the last document you retrieved.
-
-
-
-
- 4.2. Downloading
- ______________________________________
-
- * If you're in an active FTP session:
-
- (1) Move the cursor to the filename you wish to download, and
- press (Enter).
-
- (2) Confirm by pressing (Enter) again.
-
- (3) Choose "Download".
-
- (4) Then you must choose what type of transfer to perform.
- Choose BINARY for compressed or executable files. Use ASCII if
- this is a text file. DOCUMENT will bring the file directly to
- the screen.
-
- You'll be informed how the transfer succeeded (usually a matter
- of seconds) and the transaction will be recorded in the Transfer
- Log.
-
-
- * If you already know the site and filename and don't want to
- visit the site:
-
-
- (1) Press (Enter) anywhere on the screen.
-
- (2) Erase whatever CHaiN captured and input the site, followed by
- "/" and then the directory and filename (no spaces). Press
- (Enter).
-
- (3) Choose "Connect".
-
- (4) Choose the correct transfer method (see above).
-
- Emcee will call the site, download the file, then logoff.
- Activity is recorded in the Transfer Log.
-
-
-
-
- 4.3. Uploading
- ______________________________________
-
- Make sure you have previously uploaded the file to you provider's
- system before uploading the file to the remote FTP site.
-
-
- (1) Connect to the site where you wish to upload the file.
-
- (2) Position Emcee in the remote FTP site's directory where you
- wish to leave the file.
-
- (3) Press <F2>.
-
- (4) Input the name of the file that you wish to upload. This
- file MUST be already present on your provider's system.
-
- (5) Choose the appropriate transfer method (same idea as
- downloads, see above).
-
- Emcee will send the file to the remote FTP site and tell you how
- it went, as well as record the transaction in the Transfer Log.
-
-
-
-
- 4.4. Transfer Log
- ______________________________________
-
- All uploading and downloading attempts are recorded in the
- Transfer Log. Press <Alt> to invoke the menubar. You'll find
- the Transfer Log under "Transfer".
-
-
-
-
- 4.4.1. Resetting the Transfer Log
- ______________________________________
-
- It may become necessary to reset or clear the transfer log of
- it's content. Press <Alt> to invoke the menubar. You'll find
- the command to Reset Transfer Log under "Transfer".
-
-
-
-
-
-
-
-
- 5. ARCHIE AND WHATIS SEARCHES°
- ______________________________________
-
- Finding available files or descriptions of files is just a
- quick Telnet trip to an anonymous Archie server. Completely
- automated file searching is one of Emcee's strong points. Emcee
- returns an easy-to-use list of sites and filenames that you can
- point-and-click on for direct access to what you want.
-
-
- * To look for filenames via Archie:
-
- (1) Press <Alt-A>. Doesn't matter if you're in an FTP session.
-
- (2) Input your requests (5 max) and press (Enter) on a blank line
- when finished.
-
- (3) Choose "Connect/Search".
-
- Emcee randomly chooses an Archie server and attempts a connection
- with it. If it fails to connect, Emcee moves to the next server,
- until a reliable server is connected with. If you know a server
- is dysfunctional, slow, or simply don't want to use the server
- Emcee is attempting to connect with, press <Esc> to move down the
- list.
-
- Emcee then requests a search and the output of this search is
- immediately placed on the screen. BEAR IN MIND, this is not the
- same structure you'll finally be presented with.
-
- Press <Esc> to abort and structure what's been found.
-
-
- * To look for file descriptions via WHATIS:
-
- (1) Press <Alt-W>.
-
- (2) Input your requests.
-
- (3) Choose "Connect/Search".
-
- Same results as an Archie search (above).
-
-
-
-
- 5.1. Viewing the Last Archie Search
- ______________________________________
-
- To display the results of the last Archie search, press <Alt> to
- get to the menubar. You can View Last Archie under "Connection".
-
-
-
-
- 5.2. Viewing the Last Whatis Search
- ______________________________________
-
- To display the results of the last WhatIs Search, press <Alt> to
- get to the menubar. You can View Last Whatis under "Connection".
-
-
-
-
- 5.3. Specifying Archie Servers
- ______________________________________
-
- There are numerous Archie servers located all over the world
- that allow anonymous access to their databases. Some work better
- than others, but all offer a wide search, sometimes over
- different FTP sites, which may lead to different listings from
- each Archie server.
-
- Emcee is compatible with most anonymous archie servers.
- Experiment; if a timeout or heavy delay occurs, keep the site
- away from your list. Emcee shuffles through a list of servers
- until connected successfully.
-
- Each server asks for at least a login name and sometimes a
- password. Most anonymous archie servers will let you in with a
- login of "archie". The ARCHIE.LST configuration file contains
- the archie.site.name, login and password of each site. Emcee
- comes PRECONFIGURED with several archie servers (many are out of
- the US and barely used at time of this writing= FAST RESPONSE!)
- Follow the format that appears in ARCHIE.LST to add more or
- rearrange the server order. (9 maximum)
-
-
-
-
-
-
-
-
- 6. PERSONAL FTP DIRECTORY
- ______________________________________
-
- This directory is your customized guide to the world of FTP.
- The sites you want to visit again, the directories you want to
- frequent, and the files you'd like to receive can be placed here.
- Each entry has a corresponding character to identify its function
- when called upon:
-
- :Visit FTP site
-
- Format: ftp.site.name
- Example: oak.oakland.edu
-
-
- ≡ :Visit FTP site, begin session in specified directory
-
- Format: ftp.site.name/directory/
- Example: oak.oakland.edu/pub/
- (!! Note the trailing slash !!)
-
-
- ¥ :Wishlist- Visit FTP site, download specified
- filename, and logoff
-
- Format: ftp.site.name/directory/filename
- Example: oak.oakland.edu/pub/README
-
-
-
- Use the Left/Right arrow keys to preset your command and
- then Up/Down keys to change entries. Hit (enter) to invoke.
-
-
- Some of the examples above use the Personal Directory to
- demonstrate how to connect to sites (Connect/Relieve). Please
- see these references for correct use.
-
- For the most part, the options available from within the Personal
- Directory should be self-explanatory.
-
- CONNECT/RELIEVE: Connects to the site listed in the entry and
- performs tasks, depending on its corresponding character (see
- above.)
-
- SEARCH: Searches the Directory for a keyword. Press <SPACE> to
- bring up the next find.
-
- ADD: Allows you to add another site to visit, directory to FTP
- to, or filename to download (see below.)
-
- REVISE: Allows you to edit the entry.
-
- ERASE: Erases the entry.
-
-
-
-
- 6.1. Adding New Sites
- ______________________________________
-
- Not only can you add new sites, but also directories and
- filenames to frequent. You may specify a site, site+directory or
- site+directory+filename (see above for example formats.)
-
- SITE: Just enter the ftp.site.name or its corresponding IP
- number.
-
- ≡ SITE/DIRECTORY: Enter the ftp.site.name, a "/" and directory
- name to start from, FOLLOWED BY TRAILING "/".
-
- ¥ SITE/FILENAME: Enter the ftp.site.name, a "/" and filename to
- retrieve.
-
- When you "Connect/Relieve" on an entry, Emcee will automatically
- perform the task according to the little graphics character
- beside each entry.
-
-
-
-
-
-
-
-
- 7. INSIDE EMCEE
- ______________________________________
-
- The following are miscellaneous commands and options to better
- understand and use Emcee.
-
-
-
-
- 7.1. CHaiN: Cursor-Happy Navigation
- ______________________________________
-
- Like the popular hypertext interface that allows you to
- follow specific information by highlighting a word or phrase,
- Emcee's CHaiN lets you point at a word (in this case a directory
- or filename) and press <Enter> to use the word as the argument
- for viewing a file, listing a directory, downloading a file and
- even connecting to another site. CHaiNing can be done from any
- document that appears in the window.
-
- In order for this function to work, however, you'll need to
- know what text of an FTP session can be used as an argument. For
- instance, while viewing a directory, you may see something like:
-
- Size Filename/Directory
- -------- ----------
- -rw-r--r-- 1 pvo staff 6130 Aug 3 10:24 README
- -rw-r--r-- 1 pvo staff 512 Jan 6 1993 Adlib-Gold
- -rw-r--r-- 1 pvo staff 512 Apr 16 1992 Alesis-D4
- -rw-r--r-- 1 pvo staff 512 Dec 11 1992 Analog_FAQ
- -rw-r--r-- 1 pvo staff 90926 May 18 1993 CD-ROM.txt
- -rw-r--r-- 1 pvo staff 512 Apr 19 13:36 CDI-FAQ
- -rw-r--r-- 1 pvo staff 512 Mar 4 1992 Casio-VZ
- -rw-r--r-- 1 pvo staff 512 Apr 15 1992 Chroma
-
- ^^^^^^^^^
- |||||||||
-
- The "stuff" in the far right-hand of the screen is what you
- want to move the cursor to. It contains both directory and file
- names. Press (Enter) to record the word the cursor is
- immediately touching. You'll have the chance to edit the word if
- necessary, and press (Enter) again to confirm the argument.
-
- You can now use this word to perform the following commands:
-
-
- DIRECTORY
- Sends a directory command to the remote FTP system, using the
- CHaiNed argument as the directory to list.
-
- A directory usually has an exact file size that's a multiple
- of 512. If you accidentally perform a directory listing on a
- file, you can <Esc> and try again.
-
- Each directory listed REMAINS IN MEMORY for later access, and
- the entire line where you CHaiNed from becomes highlighted. To
- access this directory again, you must return the cursor to the
- original word and hit <Enter>, this time only once.
-
-
- VIEW
- Sends a view command to the FTP site, using the CHaiNed
- argument as the file to view. Each file viewed REMAINS IN
- MEMORY for later access, and the entire line where you CHaiNed
- from becomes highlighted. To access this file again, you must
- return the cursor to the original word and hit (enter) only
- once.
-
- Emcee supports HTML (Hypertext Markup Language). These files
- normally have "html" somewhere in the name. When the file has
- been completely received, Emcee attempts to translate it. All
- FTP sites or filenames listed are highlighted and can be
- CHaiNed to immediately.
-
-
- DOWNLOAD
- Sends a download command (get) to the FTP site, this time using
- the CHaiNed argument as the filename to download.
-
- You'll be asked the type of method that should be used to
- transfer the file from the site to your provider's computer.
- Use BINARY for executable or compressed files, and ASCII for
- general text files. Choose DOCUMENT if you'd like the file's
- contents to appear on the screen. NOTE: Document transfers are
- kept in Emcee and available from the LAST DOCUMENT command from
- the menubar for later access.
-
- You'll then be asked to enter a destination for this file.
- Type in the name it should be saved to your provider's system
- under.
-
-
- CONNECT
- Much like the "Connect/Relieve" command from your Personal FTP
- Directory. Using the CHaiNed argument, Emcee automatically
- connects with a site and lists a home directory or downloads a
- file, according to the entry's format.
-
- Archie searches are automatically formatted to work with this
- command.
-
-
- PERSONAL
- If you're attempting to save the CHaiNed argument to you
- Personal Directory as a SITE, SITE/DIR or FILE entry, use the
- Up/Down cursor keys to specify it and press (enter). Emcee
- alters the argument accordingly.
-
-
-
-
- 7.2. Specifying a Home Page
- ______________________________________
-
- Popular these days is the ability to move from one network to
- another using as few keystrokes as possible. "Home Pages" are
- used to direct people and computers to different places, and with
- Emcee's CHaiN feature, this type of traveling can be achieved
- here too, using FTP.
-
- With Emcee, a Home Page is actually a text file that gets
- displayed under the "FTP Home Page" command from the menubar.
- This text file can hold any type of content, including links to
- FTP sites.
-
- * To import a text file to be used as a Home Page...
-
- (1) Rename the file to "HOMEPAGE", and
- (2) place the file in the directory where Emcee resides.
-
- Emcee will recognize this file when started and translate it for
- use within Emcee. Whenever you wish to view it, use the "FTP
- Home Page" command under Connections from the menubar.
-
-
- * This can also be achieved WHILE using Emcee.
-
- If you've just retrieved a document to screen that you want to
- use as your Home Page...
-
- (1) Perform a "WINDOW->DISK" command under Window from the
- menubar <Alt>.
-
- (2) Save the document as "HOMEPAGE", making sure it get's placed
- in Emcee's directory. The actual Home Page will change when you
- start Emcee again.
-
-
-
-
- 7.3. Searching the Window
- ______________________________________
-
- To look for a keyword in the window that's currently being
- displayed...
-
- (1) Press <F5> and enter a keyword.
-
- Emcee will look through the entire document and move the cursor
- to the keyword, if found. Use <SPACE> to bring up the next find.
-
-
-
-
- 7.4. Saving the Window to Disk
- ______________________________________
-
- * To save only what's being displayed in the window...
-
- (1) Use the "In View->DISK" command under Window from the menubar
- <Alt>.
-
- (2) Input a valid filename to save the filename as.
-
-
- * To save the entire document that's in the window...
-
- (1) Use the "Window->DISK" command under Window from the menubar
- <Alt>.
-
- (2) Input a valid filename to save the filename as.
-
-
-
-
- 7.5. Printing the Window
- ______________________________________
-
- * To print only what's being displayed in the window...
-
- (1) Use the "In View->PRINTER" command under Window from the
- menubar <Alt>.
-
-
- * To print the entire document that's in the window...
-
- (1) Use the "Window->PRINTER" command under Window from the
- menubar <Alt>.
-
-
- If your printer port is defined correctly in SETUP, Emcee will
- print your selection.
-
-
-
-
-
-
-
-
- 8. TECHNICAL SUPPORT
- ______________________________________
-
- Should something not work properly or an error occurs, feel
- free to contact me. Emcee has been tested and successfully run
- from remote, dial-up TBBS and Linux systems.
-
-
- Internet email: jj.heim@boardwatch.com
- Voice Phone: 303-696-8983
-
-
-
-
- 8.1 Further Information
- ______________________________________
-
- If you're new to the whole Internet thing, check out Brendan
- P. Kehoe's "Zen and the Art of the Internet: A Beginner's Guide,"
- available in electronic text at several FTP sites and online
- services everywhere.
-
- If you're just looking for further information on FTP, the
- Internet or anything in general, look for FAQ files (frequently-
- asked questions) available on an enormous amount of information,
- via FTP sites everywhere.
-
-
-
- Good luck and happy FTPing!
- JJ Heim, Emcee author
-
-